perm filename LOGOUT.BH[UP,DOC]2 blob sn#125970 filedate 1974-10-21 generic text, type C, neo UTF8
COMMENT āŠ—   VALID 00002 PAGES
C REC  PAGE   DESCRIPTION
C00001 00001
C00002 00002	The command for terminating a  session on the computer is  KJOB (kill
C00008 ENDMK
CāŠ—;
The command for terminating a  session on the computer is  KJOB (kill
job), which runs the LOGOUT program.  The command may  be abbreviated
K.  It takes an  optional switch argument to select  various optional
features.   The  OPTION.TXT  file  is  also  used  to  control logout
options.

The LOGOUT  program normally  types out  several lines  of accounting
information, e.g., computer time used.  It deletes any files  in your
directory with extension RPG (these are the files the RPG system uses
to remember the commands you gave), and if there are no files in your
directory, it deletes the directory itself.

If you are  not also logged in elsewhere  and if you have  the RPGSAV
option  (see below),  LOGOUT will  look  for TMPCOR  files (simulated
files in core  storage) used by some  processors for remembering  RPG
commands instead  of disk files,  and copy them  to the disk  so they
will be remembered the next time you log in.  Note that this will not
be done if you use the /F switch (below) for fast  logout.  Note also
that LOGOUT does  not save TMPCOR files created  under an alias, even
if you  are still  aliased when  you  give the  KJOB command.    (The
monitor resets  your disk PPN  to your  logged-in PPN before  running
LOGOUT.)

You are told if you have another job logged in with the same PPN, and
if you  have assigned any  private devices (mag  tape, etc.)  you are
reminded to unload them.

This normal  processing can  be affected by  switches in  the command
itself or by options in the OPTION.TXT file.  LOGOUT looks for a line
in OPTION.TXT of the form

LOGOUT:RPGSAV,ME,FAST;

(Of course,  you need  not use  all the  options.) These  options, if
found, have the following effect:

  RPGSAV   Don't delete RPG files.
  ME       Type a friendly message (try it).
  FAST     Just log out, don't delete anything,
           don't save TMPCOR, don't print statistics.

Switches are single letters  preceded by a slash (e.g.,  KJOB/F). The
switches are:

  /K       Kill RPG files (only necessary with the RPGSAV option.)
  /S       Save RPG files.
  /M       Type a message, like the ME option.
  /F       Fast logout.
  /Z       Zero the disk.  Deletes all your files, after asking if
           you really mean it.

There are two  functions of LOGOUT  which are performed when  you are
not also logged in elsewhere, regardless of options or switches used:
the "creation  date" entry  for  your file  directory is  updated  to
reflect your most recent logout (this information is used by FINGER),
and if you have a file named LOGOUT.MSG, it is typed and deleted.

There are two  other monitor commands  which run the  LOGOUT program,
for logging in with another PPN and for attaching to an existing job:

KLOG logout-switches ppn
KATTACH jobnum ppn logout-switches

The logout switches are as described above.  The other  arguments are
in the required form for the LOGIN and ATTACH commands.

Finally, there is a LOGOUT command, which is exactly the same as KJOB
but no arguments are allowed.

Any of these commands, when typed at a PTY which is not  owned  by  a
TELNET  server  (that is, not the virtual terminal of an ARPA network
user), simply kills the job without running the LOGOUT program.  This
has approximately the effect of KJOB/F.